---
layout: docs
page_title: 'nomad namespace command reference'
description: |
  The nomad namespace reference command interact with namespaces. Create, inspect, and delete a namespace. Display status information and list namespaces.
---

# Command: namespace

The `namespace` command is used to interact with namespaces.

Visit [Create and use namespaces](/nomad/docs/govern/namespaces) for more information.

## Usage

Usage: `nomad namespace <subcommand> [options]`

Run `nomad namespace <subcommand> -h` for help on that subcommand. The following
subcommands are available:

- [`namespace apply`][apply] - Create or update a namespace
- [`namespace delete`][delete] - Delete a namespace
- [`namespace inspect`][inspect] - Inspect a namespace
- [`namespace list`][list] - List available namespaces
- [`namespace status`][status] - Display a namespace's status

In [federated][] clusters, all namespace updates are forwarded to the
[`authoritative_region`][] and replicated to non-authoritative regions. This
requires that ACLs have been bootstrapped in the authoritative region.

[apply]: /nomad/commands/namespace/apply 'Create or update a namespace'
[delete]: /nomad/commands/namespace/delete 'Delete a namespace'
[inspect]: /nomad/commands/namespace/inspect 'Inspect a namespace'
[list]: /nomad/commands/namespace/list 'List available namespaces'
[status]: /nomad/commands/namespace/status "Display a namespace's status"
[federated]: //nomad/docs/deploy/clusters/federate-regions
[`authoritative_region`]: /nomad/docs/configuration/server#authoritative_region
